home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 09 Application Software / SPDCNV.DOC < prev    next >
Text File  |  2019-04-13  |  4KB  |  92 lines
  1.                     Speedscript File Conversion
  2.  
  3.  
  4.  
  5.      This is the .DOC file for spdcnv.img.  This, being the latest version,
  6. will convert Speedscript files to either ASCII or PETSCII.
  7.  
  8.  
  9.                     Changes from the Original Version
  10.  
  11.  
  12.      The first version was written entirely in BASIC. In order to speed up the
  13. conversion process, proceedures were changed, and a major part of the
  14. conversion is done by 3 'RELOCATABLE' machine language routines. For those who
  15. have something that is running starting at 49152 in memory will want to pick
  16. another place for these routines. I'm sure everyone has there own favorite
  17. places for something like that.
  18.  
  19.      Since this new version reads the entire text file into memory first, it
  20. was necessary to protect it from BASIC. To do this, the top of memory is
  21. lowered at the very beginning of the program.
  22.  
  23.                          Instructions
  24.  
  25.  
  26.      Load in the program. If you need to relocate the ML portion of the
  27. program, change the variable ML in line 10 of the program. All sys's to these
  28. routines will adjust accordingly. This version is written for use with both
  29. disk and tape. It does, however write a sequential tape file. 
  30.  
  31.      On start up, you will be asked for a device number, which is preset to 8
  32. for disk. If you wish to permanently change your version to another device
  33. number, change the number in line 7 of the program. If 8 is the device you
  34. desire, press RETURN. Otherwise, select the device number you want, and press
  35. RETURN.
  36.  
  37.      At this point, the ML portion of the program is loaded into memory,
  38. beginning at the location defined by the variable ML.
  39.  
  40.      Next, you will be asked which way you would like to convert your file
  41. (ASCII or PETSCII). Preset on this is ASCII. If this is acceptable, press
  42. RETURN, or select 'P' and press RETURN.
  43.  
  44.      Next is 'EDITING REQUIRED'. If you have pre-edited your material from
  45. Speedscript by placing returns in the text where you want them, answer (N)o to
  46. the question. Preset is (Y)es.
  47.  
  48.      If editing is desired, you must determine maximum line length. Since the
  49. ML does search back from a maximum line length, you will never have lines
  50. longer than what you have specified. Preset on this is 40 (for 40 columns).
  51.  
  52.      You will now be asked for the original file name, and then the new file
  53. name. Answer both of these questions accordingly.
  54.  
  55.      The last question you will be asked (disk users only, tape users
  56. automatically have this function) is if you need to change the media to receive
  57. the new file. For tape users, this is forced to yes to allow you to reset the
  58. dataset to for the info. Disk users may find this option handy to place the
  59. conveted file onto there terminal program disk for later uploading. The disk is
  60. initialized from in the program after the change to avoid overwriting other
  61. data.
  62.  
  63.      From here on, the program will take care of things. The file is printed on
  64. the screen as it is written to the receiving device. This is not necessary, but
  65. was done so the results could be seen immediately.
  66.  
  67.      To give you an idea of the difference between this version, and the first
  68. version, I tried timing a conversion using both. The file I used was a little
  69. over 5800 bytes long. The original version took 10 minutes 35 seconds to
  70. convert. This version took 2 minutes, 2 seconds. Time may vary for you, but
  71. this seems to hold true. Tape users will find this takes longer for them, but
  72. the same file was loaded from tape, converted, and sent back to tape in just a
  73. touch over 6 minutes. But don't hold me to that!
  74.  
  75.      There is one hitch in the program. Unlike the original, this one does not
  76. detect a leading space at the beginning of a sentence. So unless you don't care
  77. about the finished text, don't double space unless you have to. I'll try to
  78. cure this in another version.
  79.  
  80.      Watch for the ASCII and PETSCII to Speedscript converter to come.
  81.  
  82.      I would like to hear any comments or suggestions anyone has about this
  83. program. You can leave me a message on the board, or Email me. Hope this is
  84. what all you SS users were looking for.
  85.  
  86.  
  87. Regards,                Steve Hammer
  88.                          74776,1570
  89.  
  90.  
  91.  
  92.